/**
 * @name Lines of comments in files
 * @kind treemap
 * @description Measures the number of lines of comments in each file (including docstrings,
 *              and ignoring lines that contain only code or are blank).
 * @treemap.warnOn lowValues
 * @metricType file
 * @metricAggregate avg sum max
 * @id py/lines-of-comments-in-files
 */

import python
private import LegacyPointsTo

from ModuleMetrics m, int n
where n = m.getNumberOfLinesOfComments() + m.getNumberOfLinesOfDocStrings()
select m, n order by n desc
